昨天我們用 git init 建立了一個全新的 Git 世界，但目前這個世界就像你的私人日記，只有你一個人知道它的存在。

不過，現實開發中，專案通常不只是自己玩 。你可能想：

• 把專案推到 GitHub、GitLab，讓全世界（或至少團隊）看到
• 備份版本，避免電腦壞掉或檔案消失
• 和同事一起開分支、合併、協作，保持專案更新

這時候，就需要今天的主角登場——git remote。

它就像是給你的 Git 世界裝上了「傳送門」，把本地專案和遠端倉庫連接起來。
從此，你的 commit 不再孤單旅行，而是進入共享世界，和團隊一起「飛越時空」 。

為什麼需要 git remote ？

遠端（remote）是指 儲存在其他伺服器上的 Git 倉庫。作用包括：

• 與團隊共享專案
• 備份專案歷史
• 進行分支協作

簡單來說，remote 就是「遠端倉庫的暱稱」。

• 本地端（local repo）存放在你電腦裡，但遠端（remote repo）才是大家能一起同步的地方。
• 就像你手機裡的照片（local），如果只存在手機裡，那就只有你能看；傳上 Google 相簿（remote），朋友才能一起瀏覽。

每個遠端可以有一個簡短名稱，例如最常見的 origin，方便後續操作。

基本操作

新增遠端

git remote add <remoteName> <URL>
git remote add origin https://github.com/yourname/project.git

• 此操作將本地專案與遠端倉庫關聯。
• origin 是慣例名稱，表示「專案的來源」。

也可以使用其他名稱，例如用 github：

git remote add github https://github.com/yourname/project.git

修改遠端名稱

git remote rename <oldNmae> <newName>
git remote rename origin gitlab

• rename 重新命名遠端名稱，會把 origin 改成 gitlab。

修改遠端 URL

git remote set-url origin <newURL>
git remote set-url origin git@github.com:yourname/project.git

• 常見用途：把 HTTPS 改成 SSH，避免每次輸入密碼。

查看遠端

git remote -v

• -v verbose 詳細顯示新增的遠端及其 fetch / push 的 URL，來確認設定是否正確。

範例輸出：

origin  git@github.com:yourname/project.git (fetch)
origin  git@github.com:yourname/project.git (push)

刪除遠端

git remote remove origin
git remote rm origin   #縮寫

• 不再使用的遠端可以隨時刪除。
• 如果要重設遠端，先移除再新增。

與遠端的互動

第一次把分支推到遠端時，Git 不知道要對應到哪裡，所以需要指定上游分支：

git push --set-upstream origin main
git push -u origin main   #縮寫

• -u 會建立一個「追蹤關係」（upstream tracking）。

• 告訴 Git：本地的 main 分支要對應遠端 origin/main 分支。

• 之後在這個分支上，就可以直接用：

  git push   # 會自動推到 origin/main
  git pull   # 會自動從 origin/main 拉取
  

  而不用每次都打 git push origin main。

遠端只是「指標」，不會自動同步內容，要搭配：

• git push：把本地 commit 傳到遠端
• git pull：把遠端更新拉到本地

[ Local Repo ]  <-- push/pull -->  [ Remote Repo (GitHub) ]

(先知道就好，系列後續會展開說明)

常見錯誤

• 只 init 沒有 remote

  → git push 會報錯，Git 不知道要推去哪裡。

• URL 打錯

  → git clone 或 git push 會失敗，用 git remote -v 檢查。

• 分支對不上

  → 第一次推送要加 -u，確保本地分支與遠端分支建立追蹤關係。

小挑戰 💪

1. 查看本地 Git 專案的遠端設定，確認是否有 origin。
2. 新增一個遠端 repository（GitHub 或 GitLab）。
3. 修改遠端 URL，測試用 SSH 或 HTTPS 連線。
4. 刪除遠端，確認 git remote -v 已無該遠端。

小結

• git remote 是連結本地與遠端的橋樑
• 有了遠端，才可以使用 git push / git pull 與團隊協作
• 記得確認遠端 URL、分支名稱，避免推送錯誤

接下來，我們就要學習如何把本地的 commit 送到遠端，正式開始多人協作的旅程！ 🚀